From: Florian Müllner Date: Thu, 11 Sep 2025 19:20:08 +0000 (+0200) Subject: docs: Replace references to --nested with --devkit X-Git-Tag: archive/raspbian/50.5-1+rpi1~1^2~95^2^2~14 X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=d62519d1a71f0936242236f4cd6936107ecd8993;p=gnome-shell.git docs: Replace references to --nested with --devkit The --devkit option is strongly recommended over the old --nested nowadays, not least because the latter option no longer exists by default (as it is tied to the X11 backend). Remove the section on global shortcuts and workaround for looking glass, as Devkit supports inhibiting keyboard shortcuts. Part-of: --- diff --git a/docs/building-and-running.md b/docs/building-and-running.md index 091d523b4..ad29c6b28 100644 --- a/docs/building-and-running.md +++ b/docs/building-and-running.md @@ -61,25 +61,15 @@ Refer to the [README][toolbox-tools] for further information on the scripts. ## Running a nested instance -It is possible to run gnome-shell as "nested" instance in a window. +It is possible to run gnome-shell as nested instance using Devkit. The `run-gnome-shell` script will automatically do that when run from a graphical session, or you can run the following command: ```sh -$ WAYLAND_DISPLAY=shell-test-1 dbus-run-session \ - gnome-shell --wayland-display=shell-test-1 --nested +$ dbus-run-session gnome-shell --wayland --devkit ``` -There are limitations to the nested instance, such as keyboard shortcuts -usually not getting to the nested compositor. - -In order to still bring up the [Looking Glass][lg] debugger, you can -use an [extension][lg-button] as workaround. - -[lg]: ./looking-glass.md -[lg-button]: https://extensions.gnome.org/extension/2296/looking-glass-button/ - ## Native Sometimes it's necessary to run the "native backend", on real display hardware.